home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Workbench Design
/
WB Collection.iso
/
workbench werkzeuge
/
commoditys
/
cx13
/
cx.guide
(
.txt
)
< prev
next >
Wrap
Amigaguide Document
|
1996-04-07
|
20KB
|
589 lines
@database CX.guide
@VER: CX.guide 1.3
1994 Fin Schuppenhauer (24 Sep 1994)
@(C)
1994 POSTCARDWARE
@author Fin Schuppenhauer
@node Main "CX: Benutzerhandbuch"
@{b}CX - Benutzerhandbuch@{ub}
1994 Fin Schuppenhauer
CX ist POSTCARDWARE. Wenn Dir dieses Programm gef
llt, dann schicke
mir doch eine Postkarte aus Deinem Heimatort. Ansonsten d
rfen dieses
Programm und die dazugeh
rigen Dateien beliebig weiterkopiert
werden. Einzige Beedingung: Mein Copyright mu
bestehenbleiben und
der Vertrieb darf nicht zu kommerziellen Zwecken geschehen.
@{b}Inhalt:@{ub}
@{" Was ist CX ? " link CX}
@{" Features " link Features}
@{" Lieferumfang / Systemvoraussetzungen " link Lieferumfang}
@{" Installation " link Installation}
@{" Bedienung " link Bedienung}
@{" Historisches " link Historisches}
@{" Bugs & Future " link Bugs}
@{" Dolmetscher " link Dolmetscher}
@{" Meine Adresse " link Adresse}
@endnode
@node CX "Was ist CX ?"
@{b}Was ist CX ?@{ub}
CX ist ein Ersatz f
r das "Exchange"-Programm der Workbench. Ich
habe es geschrieben, da ich schon immer mal ein Commodity schreiben
wollte und mir bei "Exchange" eine wichtige Funktion fehlte: Die
glichkeit alle Commodities auf einmal zu entfernen.
CX sollte weitestgehend kompatibel zu "Exchange" sein, bietet aber
eine Menge mehr @{"Features" link Features}.
@endnode
@node Features
@{b}Features@{ub}
+ font-sensitiv
+ multi-lingual (deutsch, englisch, schwedisch)
+ M
glichkeit, alle Commodities zu (de)aktivieren bzw. zu entfernen
+ Gadgets
ber Tastatur ansprechbar
+ Scrollen in der Liste mit den Cursortasten
+ Doppelklick bzw. RETURN zeigt das Interface des gew
hlten
Commodity
+ immer ein Eintrag sichtbar
+ ausf
hrliche Dokumentation
+ Quellcode dabei
@endnode
@node Lieferumfang "Lieferumfang / Systemvoraussetzung"
@{b}Lieferumfang:@{ub}
Dieses Paket besteht aus folgenden Dateien:
txt (dir) : Quelltexte
CommoditiesPrivate.def : Priv. Funktionen d. commodities.library
CX.mod : Sourcecode
CXCatalog.def : Zusatzmodul f.d. Lokalalisierung
ListsAndNodes.def : Verwaltet Listen etc. (z.B. Sortieren)
ListsAndNodes.mod
sym (dir) : Symboldateien
CommoditiesPrivate.sym
CXCatalog.sym
ListsAndNodes.sym
obj (dir) : Objektdateien
ListsAndNodes.obj
Catalogs (dir) : Kataloge
deutsch (dir) : f
r unsere Landsleute
CX.catalog
CX.ct
Svenska (dir) : f
r Schweden (
bersetzt von
CX.catalog : Johan Billing)
CX_svenska.ct
README
CX.cd : Description File
empty.ct : F
bersetzer
CX : Das Programm
CX.doc : Die englische Doku
CX.guide : liest Du gerade
CX.readme : Kurzbeschreibung f
rs AmiNet
Beim Weitergeben m
ssen alle Dateien kopiert werden.
@{b}Systemvoraussetzungen:@{ub}
Folgendes wird ben
tigt:
- ein Amiga
- OS 2.1 oder h
- eine stromliefernde Steckdose
- eine Postkarte und eine Briefmarke (siehe @{"hier" link Adresse})
@endnode
@node Installation
@{b}Installation@{ub}
r die Installation gibt's hier mal kein Installer-Skript (ich
habe sowas n
mlich noch nie geschrieben). Denoch brauchst Du kein
St
ck Text zu schreiben, denn wir werden die Installtion mit Hilfe
von @{AmigaGuide} vornehmen. Klingt vielleicht crazy, aber das
funktioniert!
1. Schritt:
Hier werden die Dateien CX und CX.info in das Verzeichnis
SYS:Tools/Commodities kopiert, wenn Du den folgenden Button
anklickst:
@{"CX kopieren" SYSTEM "copy (CX|CX.info) TO SYS:Tools/Commodities CLONE"}
Unter OS 3.0+ kannst Du auch ein anderes Verzeichnis w
hlen.
Klicke dazu nacheinander die folgenden Buttons an:
@{"Verzeichnis w
hlen" SYSTEM "RequestFile >ENV:CX DRAWERSONLY"}
@{"Dateien kopieren " SYSTEM "copy (CX|CX.info) TO $CX CLONE"}
2. Schritt:
Hier werden wir nun diese AmigaGuide-Datei, die Du gerade liest
in das Verzeichnis S: kopieren, wenn Du denn folgenden Button
anklickst:
@{"Guide-Datei nach S:" SYSTEM "copy CX.guide#? TO S: CLONE"}
Unter OS 3.0+ kannst Du Dir auch ein anderes Verzeichnis w
hlen:
@{"Verzeichnis w
hlen" SYSTEM "RequestFile >ENV:CX DRAWERSONLY"}
@{"Dateien kopieren " SYSTEM "copy CX.guide#? TO $CX CLONE"}
3. Schritt:
Programme werden dann erst nett, wenn ihre Schalter und Men
auch in der eigenen Landessprache daherkommen. Fest eingebaut
ist die englische Beschriftung; weitere Sprachen
ber die
folgenden Kataloge (Klick auf den Button kopiert den Katalog).
@{"deutsch " SYSTEM "copy catalogs/deutsch/CX.catalog TO LOCALE:catalogs/deutsch" CLONE}
@{"schwedisch" SYSTEM "copy catalogs/Svenska/CX.catalog TO LOCALE:catalogs/Svenska" CLONE}
@endnode
@node Bedienung
@{b}Bedienung@{ub}
@{" Aufruf von der Workbench " link Workbench}
@{" Aufruf aus der Shell " link Shell}
@{" Die Men
s " link Men
@{" Das Fenster " link Fenster}
@endnode
@node Workbench "Aufruf von der Workbench"
@{b}Aufruf von der Workbench@{ub}
CX wird einfach per Doppelklick auf sein Piktogramm gestartet. Es
ffnet sein Fenster und dann k
nnen die angezeigten Commodities
kontrolliert werden.
CX kann
ber ToolTypes gesteuert werden:
CX_POPUP:
Mit CX_POPUP=YES (voreingestellt) wird das Fenster von CX
beim ersten Start ge
ffnet, mit NO wird CX im Hintergrund
gestartet.
CX_POPKEY:
Hier kann der Tastenbefehl (@{"Hot Key" link Hotkey}) ver
ndert werden. Wird
der @{"Hot Key" link Hotkey} gedr
ckt,
ffnet CX sein Fenster. Voreingestellt
ist CX_HOTKEY=control alt help.
CX_PRIORITY:
Bestimmt die Priorit
t, mit dem CX laufen soll.
Voreingestellt ist CX_PRIORITY=0.
DONOTWAIT:
Wenn CX in der Schublade WBStartup abgelegt wurde, sollte
dieses Merkmal gesetzt werden.
REQUESTER:
M
gliche Werte: YES oder NO. Bei YES erscheinen
Sichheitsabfrage-Requester, z.B. wenn man alle Commodities
entfernen m
chte (derzeit auch nur dort).
@endnode
@node Shell "Aufruf aus der Shell"
@{b}Aufruf aus der Shell@{ub}
CX kann nat
rlich auch von der Shell aus gestartet werden:
CX [CX_POPKEY=<hotkey>|CX_POPUP=<YES|NO>|CX_PRIORITY=<n>|
REQUESTER=<YES|NO>]
D.h. als Parameter sind die
blichen @{"Tooltypes" link Workbench} zul
ssig.
@endnode
@node Men
s "Die Men
@next Fenster
@{b}Die Men
s@{ub}
Klick auf den Men
punkt, zu dem Du Informationen w
nscht:
Projekt Kontrolle
------------------------------------------------------------------
@{"
ber ... ?" link ABOUT} @{"Alle deaktivieren D" link DISABLEALL}
@{"Verbergen V" link HIDE} @{"Alle aktivieren E" link DISABLEALL}
@{"Beenden Q" link KILL} @{"Alle entfernen K" link KILLALL}
@endnode
@node Fenster "Das Fenster"
@prev Men
@next Historisches
@{b}Das Fenster@{ub}
Wenn CX sein Fenster
ffnet, siehst Du ungef
hr folgendes. F
weitere Informationen klicke einfach auf den entsprechenden Button.
----------------------------------------------------------------
@{"|+|" link HIDE} CX: @{"Tastenbefehl" link Hotkey} = <control alt help> |#|
|----------------------------------------------------------------|
| @{"Verf
gbare Commodities" link LIST} @{"Information" link Information} |
| ---------------------- ----------------------------------- |
|| Commodity 1 | | CX V1.3
1994 Fin Schuppenhauer | |
|| Exchange | | Steuert Commodities Programme | |
|| Commodity 2 | ----------------------------------- |
|| noch'n Commodity | @{" Anzeige sichtbar" link SHOW} @{" Anzeige verbergen " link HIDE} |
|| | @{" @ Aktiv " link ENABLE} @{" Entfernen " link KILL} |
|| | @{" @ Alle deaktiv. " link DISABLEALL} @{" Alle entfernen " link KILLALL} |
----------------------------------------------------------------
@endnode
@node ABOUT "
@{b}
ber@{ub}
Funktion:
Anzeigen der @{"Adresse" link Adresse} des Autors und der Copyright-Hinweise.
Aufruf:
-
ber den Men
punkt "Projekt-
ber ..."
- Shortcut RAMIGA-?
@endnode
@node HIDE "Anzeige verbergen"
@{b}Anzeige verbergen@{ub}
Funktion:
1. Schlie
en des Interface-Fensters des gew
hlten Commodity
2. Schlie
en des Fensters von CX
Aufruf:
1.
-
ber den Schalter "Anzeige verbergen"
- Taste "V"
2.
- Men
punkt "Projekt-Verbergen"
- Shortcut RAMIGA-H
- Schlie
symbol
- "ESC"-Taste
Siehe auch:
@{"Anzeige sichtbar" link SHOW}
@{"Hot Key " link Hotkey}
@endnode
@node KILL "Entfernen"
@{b}Entfernen@{ub}
Funktion:
1. Beenden und Entfernen des gew
hlten Commodity
2. CX beenden
Aufruf:
1.
-
ber den Button "Entfernen"
- Taste "E"
2.
- Men
punkt "Projekt-Beenden"
- Shortcut RAMIGA-Q
@endnode
@node DISABLEALL "Alle deaktivieren"
@{b}Alle deaktivieren@{ub}
Funktion:
Deaktivieren @{i}aller@{ui} (angezeigten) Commodities.
Aufruf:
-
ber den Schalter "Alle deaktivieren"
- Taste "D"
- Men
punkt "Kontrolle-Alle deaktivieren"
- Shortcut RAMIGA-D
Bemerkung:
Wenn diese Funktion
ber den Schalter bzw. Tastatur gew
wurde,
ndert sich die Bedeutung des Schalters. Bei einem
erneuten Klick hierauf, werden alle Commodities wieder
aktiviert.
Der Zustand des Schalters
ndert sich nicht, wenn diese Funktion
ber das Men
aufgerufen wurde.
Siehe auch:
@{"Alle aktivieren" link ENABLEALL}
@endnode
@node ENABLEALL "Alle aktivieren"
Funktion:
Aktivieren aller in der Liste angezeigten Commodities.
Aufruf:
-
ber den Men
punkt "Kontrolle/Alle aktivieren"
- Shortcut: "ramiga E"
Siehe auch:
@{"Alle deaktivieren" link DISABLEALL}
@endnode
@node KILLALL "Alle entfernen"
@{b}Alle entfernen@{ub}
Funktion:
Beenden und Entfernen @{i}aller@{ui} (angezeigten) Commodities.
Aufruf:
- Schalter "Alle entfernen"
- Men
punkt "Kontrolle-Alle entfernen"
- Shortcut RAMIGA-K
Bemerkung:
Wenn das Merkmal REQUESTER auf YES gesetzt ist, erscheint zuvor
eine Sicherheitsabfrage.
Dieser Button ist der einzige Grund, warum ich CX geschrieben habe.
F
r ein Programm ben
tigte ich allen verf
gbaren Speicher. Per Hand
meine sieben, acht Commodities zu entfernen war mir auf die Dauer
zu m
hselig.
Siehe auch:
@{"Aufruf von der Workbench" link Workbench}
@endnode
@node LIST "Listen-Gadget"
@{b}Verf
gbare Commodities@{ub}
Funktion:
Anzeige alle im System befindlichen Commodities.
Bedienung:
1. Mit der Maus:
- Klick auf Eintrag zeigt dessen Informationen in der
Bevel-Box an.
- Doppel-Klick
ffnet zus
tzlich noch das Interface-Fenster
2. Mit der Tastatur
- Taste "c" selektiert den n
chsten Eintrag
- Taste "C" den vorangegangenen
- Cursor-Up selektiert den vorangegangen Eintrag; nach dem
ersten Eintrag wird der letzte ausgew
- Cursor-Down w
hlt den n
chsten Eintrag und springt am Ende
der Liste auf den ersten zur
- Shift-Cursor-Up w
hlt den ersten Eintrag
- Shift-Cursor-Down selektiert den letzten Eintrag
- RETURN zeigt das Interface-Fenster des gew
hlten Eintrags
an (wenn vorhanden)
Siehe auch:
@{"Information " link Information}
@{"Anzeige sichtbar " link SHOW}
@endnode
@node SHOW "Anzeige sichtbar"
@{b}Anzeige sichtbar@{ub}
Funktion:
Besitzt das gew
hlte Commodity ein Interface-Fenster, so kann es
mit dieser Funktion angezeigt werden.
Aufruf:
-
ber den Schalter "Anzeige sichtbar"
- Taste "S"
- RETURN
- Doppelklick auf den Eintrag in der Liste
Bemerkung:
Im aktiven Zustand kann das Fenster von CX auch
ber dessen Hot
Key ge
ffnet werden.
Siehe auch:
@{"Verf
gbare Commodities" link LIST}
@{"Anzeige verbergen " link HIDE}
@{"Hot Key " link Hotkey}
@endnode
@node ENABLE "Aktiv / Inaktiv"
@{b}Aktiv / Inaktiv@{ub}
Funktion:
Aktiviert bzw. deaktiviert den gew
hlten Eintrag. Das
Cycle-Gadget zeigt den aktuellen Zustand des Commodity an.
Aufruf:
- Cycle-Gadget "Aktiv/Inaktiv"
- Taste "A"
Bemerkung:
Gibt es eigentlich eine M
glichkeit, ein Zeichen in den
Eintr
gen eines Cycle-Gadget zu unterstreichen?
@endnode
@node Information
@{b}Information@{ub}
Funktion:
In diesem Anzeigebereich wird in der ersten Zeile der Titel des
gew
hlten Commodity angezeigt (in der Liste steht dessen Name),
in der zweiten Zeile eine Kurzbeschreibung, wof
r jenes
Commodity gedacht ist.
Siehe auch:
@{"Verf
gbare Commodities" link LIST}
@endnode
@node Hotkey "Hot Key"
@{b}Hot Key@{ub}
Funktion:
Im aktiven Zustand kann das Interface-Fenster von CX
ber einen
Tastenbefehl, einen sog. Hot Key, ge
ffnet werden.
Der aktuelle Hot Key wird in der Titelleiste angezeigt.
Voreingestellt ist die Tastenkombination <control alt help>.
Der Tastenbefehl kann
ber das Merkmal CX_POPKEY eigenen W
nschen
angepa
t werden.
Siehe auch:
@{"Aufruf von der Workbench" link Workbench}
@{"Aufruf aus der Shell " link Shell}
@{"Aktiv / Inaktiv " link ENABLE}
@endnode
@node Historisches
@prev Fenster
@{b}Historisches@{ub}
Version Datum Wie, was und warum
------------------------------------------------------------------
V 1.0 06 Sep 94 Erste Ver
ffentlichung im Aminet geplant
V 1.1 13 Sep 94 Ja, ja, ja. Kaum war ich aus der Uni zur
wo ich mein vermeintlich geniales Programm ins
Aminet gepackt hatte, muste ich mit Grauen
feststellen, da
es in bestimmten Situation
abschmierte; manchmal sogar das ganze System
"zertr
mmerte". Ok, hier die Liste was neu
ist:
Beseitigte Fehler:
- Laufzeitfehler, wenn im verborgenen Zustand von CX ein
ListChg-Kommando eintraff (man sollte keine
nderungen an
Fenstern vornehmen, die gar nicht da sind...)
- Laufzeitfehler, trat ein, wenn CX mit CX_POPUP=NO
aufgerufen wurde
- Fr
her oder sp
terer Systemcrash, wenn das Fenster von CX
NICHT
ber das "Anzeige verbergen" (oder Taste "V"),
sondern
ber Men
, Close-Gadget oder ESC geschlossen wurde
(eine msg wurde an einen nicht mehr vorhandenen Reply-Port
geschickt; hat mich eine ganze Nacht gekostet - nix. Am
n
chsten Morgen war's dann sofort klar. Was folgern wir
wieder mal daraus? Wenn etwas partout nicht funktionieren
will, erstmal 'ne Nacht dr
ber schlafen!)
- Teile der Men
texte korrigiert
- Die in der Anleitung erw
hnten Probleme (Gadget-Texte nicht
unterstrichen) traten nur bei mir auf -- ein AVAIL FLUSH
wirkt manchmal Wunder...
Neue Features:
Zur gleichen Zeit, wie ich mein Programm "aufgeladen" habe,
habe ich "CXHandler" von M. Stengle entdeckt. Mu
te ich mir
ja anschauen...
- Liste sortiert
- "Alle deaktivieren"-Schalter in Cycle-Gadget umgewandelt
- Eintr
ge in der Liste mit Cursortasten w
hlbar
- Shift-Up/Shift-Down springt zum ersten/letzen Eintrag
- gtUnderscore f
r List-Gadget
- RETURN zeigt das Interface des gew
hlten Commodity
- Doppel-Klick auf Listeintrag zeigt dessen Interface
- Cycle-Gadget kann mit Taste "A" bedient werden
- immer ein Commodity selektiert
- ESC schlie
t CX's Fenster
- Neuer Men
eintrag "
ber ..." + Requester
- Neuer Men
punkt "Alle aktivieren"
- Cataloge upgedatet
- englische Dokumentation
- Anleitung aktualisiert
V 1.3 24 Sep 94:
Neue Features:
- font-sensitiv (gew
nscht von diversen Benutzern)
- Sicherheitsabfrage bei "Alle entfernen" (Johan Billing)
- Neues Merkmal REQUESTER
- Men
-Shortcuts lokalisiert
- schwedischer Katalog (
bersetzt von Johan Billing)
- kleinere Korrekturen
@endnode
@node Bugs "Bugs & Future"
@{b}Bugs@{ub}
Folgend eine Sammlung der Bugs, bzw. Inkompatibilit
ten zum
originalen "Exchange"-Programm:
- derzeit nur englisch/deutsch
- Bei Commodities, die sich trotz Befehls vom Exchange-Programm
nicht deaktivieren ist die Anzeige nach Ausf
hrung des Befehls
falsch: Inaktiv, obwohl das Commodity weiterhin aktiv ist.
Diesen Bug hat auch das Originalprogramm "Exchange".
@{b}Future@{ub}
r die Zukunft ist folgendes geplant:
- Behebung aller mir berichteten Fehler
- Mehr Sprachen ?
- AREXX-Port ???
- Online-Hilfe ????????
@endnode
@node Dolmetscher
@{b}Dolmetscher@{ub}
Da ich nicht der Papst bin (was f
r ein Gl
ck!!!) behersche ich
leider nur einen geringen Teil der Sprachen, die auf diesem
Planeten gesprochen werden (mit meiner Muttersprache habe ich diese
Probleme manchmal auch...).
r alle Dolmetscher der Catalog-Dateien gibt es deshalb hier auch
das original Catalog-Description-File und ein Rohger
r neue
bersetzungen (catalogs/empty.ct).
Bitte schicke mir Deine
bersetzung zu, damit wir alle was davon
haben. Schon jetzt mal ein Dankesch
r Deine M
@endnode
@node Adresse "Meine Adresse"
@{b}Meine Adresse@{ub}
Die Postkarten (mit oder ohne Fehlerbericht) machen sich besonders
gut, wenn sie in meinem Briefkasten landen:
Fin Schuppenhauer
Brau
park 10
20537 Hamburg
So'n elektronischen Briefkasten habe ich auch (Adresse kann sich
aber jederzeit
ndern):
schuppenhauer@informatik.uni-hamburg.de
Ach ja, wer noch einen Amiga 4000T zu viel hat, kann mir den auch
gerne zuschicken...
Mein Dank geht an:
- Miloslaw Smyk (Autor des "CXCommander", ohne dessen Quelltext
mein Programm nie etwas gworden w
- Martin Stengle und Bernd Jessel (Autoren von "CXHandler",
diesen Bedienungskomfort mu
te ich einfach
bernehmen)
- Johan Billing (schwedische
bersetzung)
- Donald, Nico Johannisson, Michael Wagner
@endnode